home *** CD-ROM | disk | FTP | other *** search
/ Chip: 2005 Utilities / CHIP Utilities 2005 / CHIP Utilities 2005.iso / dosapps / freedos / help / deltree.en < prev    next >
Encoding:
Text File  |  2000-08-05  |  8.4 KB  |  190 lines
  1.  
  2.        ----------------------------------------------------------------
  3.        DELTREE.COM   v1.02c  04-24-2000   C. Dye   raster@highfiber.com
  4.           Freeware.  Copyright 1998-2000, Charles Dye.  No warranty!
  5.        ----------------------------------------------------------------
  6.  
  7. DELTREE.COM is a freeware clone of Microsoft's DELTREE.EXE, a utility for
  8. quickly deleting files and subdirectories.  This is a dangerous program --
  9. it can delete many things very quickly!  USE IT AT YOUR OWN RISK.  I will
  10. not be responsible for any loss of data or damage to hardware, whether
  11. caused by program error, programmer error, user error, or act of God.
  12.  
  13. DELTREE.COM is meant to be freely distributed, for the benefit of DOS users
  14. everywhere.  See the section "Distribution" below for the legalities.
  15.  
  16.  
  17.                                --------------
  18.                                GENERAL SYNTAX
  19.                                --------------
  20.  
  21. DELTREE [switches] filespec [filespec...]
  22.  
  23.   /Y    Delete specified items without prompting
  24.   /V    Report counts and totals when finished
  25.   /D    Display debug info
  26.  
  27. Switches may be uppercase or lowercase, and may begin with a slash or a minus
  28. sign.  There must be at least one filespec, and there may be more than one.
  29. Switches come before filespecs -- not after, as in most MS-DOS utilities.
  30.  
  31. Filespecs may name files, directories, or DR DOS-type list files.  You may
  32. use wildcards; all matching files and directories will be targeted.
  33.  
  34. Files will be deleted regardless of their attributes.  Directories will be
  35. deleted with all their contents.
  36.  
  37. A "file list" is a text file containing filespecs, one per line.  If you have
  38. a list of items to be deleted in a file VICTIM.TXT, type DELTREE @VICTIM.TXT
  39. (Note that the @-sign is not part of the filename, just a flag to indicate a
  40. file list.)
  41.  
  42. Unless /Y is specified, DELTREE will prompt you before deleting each item
  43. specified on the command line.  Press Y to delete the item indicated, N to
  44. let it live, or Q to quit from DELTREE.  /Y prevents the prompt -- use this
  45. switch with caution!
  46.  
  47. If /V is specified, DELTREE will report the total number of files deleted and
  48. subdirectories removed when it finishes.  If any files were deleted, the
  49. total of the files' sizes will also be reported in bytes and in kilobytes or
  50. megabytes.  The fractional part of the kilobytes or megabytes may be off by
  51. plus-or-minus one in the least significant digit.  The total size does not
  52. take cluster size into account; the amount of disk space freed may be greater
  53. than the size reported.
  54.  
  55.  
  56.                              ------------------
  57.                              ERRORLEVEL RETURNS
  58.                              ------------------
  59.  
  60.                00   Success
  61.                01   Something could not be deleted
  62.                03   User abort (Q, control-C)
  63.                16   General syntax, buffer overflow
  64.                17   Not enough memory
  65.                18   DOS 3.0 or better required
  66.                19   Problem with list file
  67.                20   Internal buffer overflow
  68.                21   Error resolving directory name (dots_fix)
  69.  
  70.  
  71.                ----------------------------------------------
  72.                INCOMPATIBILITIES WITH MICROSOFT'S DELTREE.EXE
  73.                ----------------------------------------------
  74.  
  75. This section contains technical trivia.  Most users can ignore it.
  76.  
  77. These are the known differences between Microsoft's DELTREE.EXE (I'll just
  78. call it MS's) and my own DELTREE.COM (which I'll call "mine") :
  79.  
  80. Mine will offer an additional safety prompt if items in the root directory of
  81. a non-removable drive are to be deleted and /Y was specified.  This is a
  82. deliberate incompatibility with Microsoft's, inspired by a loser who posts
  83. destructive batch files on the Internet.  There is no switch to disable this
  84. check; you must reassemble the program if you wish to remove it.
  85.  
  86. MS's DELTREE, as far as I can tell, does no error checking at all!  According
  87. to HELP, DELTREE returns Errorlevel 0 for success -- and there are no other
  88. return codes.  Even if you do totally foolish things like DELTREE CLOCK$ or
  89. removing the current directory, MS's utility reports success.  Mine will
  90. check for failures, and print an error message if something doesn't work.
  91. Mine also returns different documented Errorlevels.
  92.  
  93. MS's will sometimes call a directory a file.  Specifically, this happens when
  94. you delete a directory with any attributes set.  MS's utility will still
  95. delete the directory correctly, but this bug may confuse users.  The error
  96. appears to have been fixed in the Win95 version of DELTREE, and I don't
  97. emulate it in mine.
  98.  
  99. MS's does not deal gracefully with I/O redirection when /Y is not specified.
  100. Redirecting STDOUT makes the prompts invisible, and redirecting STDIN keeps
  101. them from working altogether.  Mine disallows I/O redirection if /Y is not
  102. specified (maps STDIN and STDOUT back to the console for user interaction.)
  103.  
  104. Mine accepts DR DOS-style file lists.  MS's does not.  If you want to delete
  105. a file or directory beginning with an at-sign, enclose the name in quotes:
  106. DELTREE "@ODDNAME"  -- this syntax is legal for both MS's and mine.
  107.  
  108. MS's will try to delete character devices, and happily assume success.  Mine
  109. will ignore device names.
  110.  
  111. MS's may display relative filenames (like "foo" or "..\subdir")  Mine will
  112. always display absolute filenames ("c:\junk\a86\foo" or "a:\subdir")
  113.  
  114. MS's allows you to enclose switches in quotes (huh?)  So DELTREE "-Y" FOO
  115. will delete FOO without prompting.  Mine interprets anything inside quotes as
  116. a filename, so DELTREE "-Y" FOO will prompt you before deleting -Y and FOO.
  117.  
  118. MS's does not support /V or /D.
  119.  
  120. Mine is smaller, and has a different filename (.COM versus .EXE)  If you keep
  121. both utilities in the same directory, typing the command DELTREE (with no
  122. extension) will start my DELTREE instead of Microsoft's.
  123.  
  124. If you're writing a batch file that needs to be compatible with MS-DOS
  125. DELTREE, check the following:  Don't use file lists, /V or /D.  Don't rely on
  126. Errorlevel.  Don't redirect output unless you specify /Y.  Don't redirect
  127. input at all.
  128.  
  129.  
  130.                                --------------
  131.                                SUNDRY CREDITS
  132.                                --------------
  133.  
  134. This program was originally created using Eric Isaacson's shareware assembler
  135. A86.
  136.  
  137. Tom Dalton suggested including a "defanged" version (DELTREE2.COM) in the
  138. archive.
  139.  
  140.  
  141.                                 -----------
  142.                                 WHAT'S NEW?
  143.                                 -----------
  144.  
  145. 1.02c   04-24-2000    4,210 bytes                              8B60E5F5  CF56
  146.  
  147. Expanded the filespec buffers to 260 bytes to handle the super-long pathnames
  148. allowed under Windows 95/98.
  149.  
  150. 1.02b   07-27-1999    4,220 bytes                              6228F0D7  5149
  151.  
  152. This release has been rewritten for NASM.  A86 is good, but it's shareware.
  153. This change allows anybody to modify the program -- not just registered A86
  154. users.  Fixed a trivial bug (incorrect Errorlevel when no filenames specified
  155. on command line.)  Minor bumming.  Also, starting with this version, I will
  156. include two binaries in the archive:  DELTREE.COM, with /Y for Microsoft
  157. compatibility; and DELTREE2.COM, which ignores any /Y.  If you like, delete
  158. DELTREE.COM and rename DELTREE2.COM.
  159.  
  160. 1.02a   05-23-1999    4,250 bytes                              3E1DFD07  3EFE
  161.  
  162. Removes the root-safety check on removable drives.
  163.  
  164. 1.02    05-19-1999    4,220 bytes                              EB86016F  FE99
  165.  
  166. Fixes a problem involving redirection of stdin under FreeDOS which could lock
  167. the computer solid.  Some code bumming.  Renamed this documentation file from
  168. DELTREE.DOC to DELTREE.TXT.
  169.  
  170.  
  171. For a complete history, see the end of the source file DELTREE.S.
  172.  
  173.  
  174.                                 ------------
  175.                                 DISTRIBUTION
  176.                                 ------------
  177.  
  178. This program is licensed under the terms of the Free Software Foundation's
  179. GNU General Public license.  You may freely distribute it under the terms of
  180. version 2 of that License, or at your option, any later version thereof.
  181.  
  182. You should have received a copy of the GNU General Public License with this
  183. program, as a file named COPYING.  If you did not receive a copy of the
  184. License, one is available from:
  185.  
  186.      Free Software Foundation, Inc.
  187.      59 Temple Place - Suite 330
  188.      Boston, MA  02111-1307, USA
  189.  
  190.